Creates a new, empty collection object.

Collection NewCollection ();

function result

A reference to the newly created collection object. The new collection contains no items and has an owner count of 1. The NewCollection function does not return an error code; it returns NULL if it cannot create a new collection object.

DISCUSSION

The NewCollection function allocates memory for a new collection object, initializes it, and returns a reference to it.

To create a copy of an existing collection object, use the CopyCollection function.

SPECIAL CONSIDERATIONS

You are responsible for disposing of collection objects that you create with this function when you no longer need them. To dispose of a collection object, use the DisposeCollection function.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)